home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / langs / clisp-c.zoo / clisp.man < prev    next >
Encoding:
Text File  |  1993-06-05  |  5.1 KB  |  199 lines
  1.  
  2.  
  3.  
  4. CLISP(1)                 USER COMMANDS                   CLISP(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      clisp - Common Lisp language interpreter and compiler
  10.  
  11. SYNOPSIS
  12.      clisp [ -h ] [ -m _✓m_✓e_✓m_✓s_✓i_✓z_✓e ] [ -s _✓s_✓t_✓a_✓c_✓k_✓s_✓i_✓z_✓e ] [ -M _✓m_✓e_✓m_✓f_✓i_✓l_✓e  ]
  13.      [ -q ] [ -i _✓i_✓n_✓i_✓t_✓f_✓i_✓l_✓e ...  ] [ -c [ -l ] _✓l_✓i_✓s_✓p_✓f_✓i_✓l_✓e ...  ] [ -x
  14.      _✓e_✓x_✓p_✓r_✓e_✓s_✓s_✓i_✓o_✓n ]
  15.  
  16. DESCRIPTION
  17.      Invokes the common lisp interpreter and  compiler.   Invoked
  18.      without arguments, executes a read-eval-print loop, in which
  19.      expressions are in turn read from standard input,  evaluated
  20.      by  the  lisp interpreter, and their results output to stan-
  21.      dard output.  Invoked with -c, the specified lisp files  are
  22.      compiled  to  a  bytecode  that  can  be executed more effi-
  23.      ciently.
  24.  
  25. OPTIONS
  26.      -h   Displays a help message on how to use clisp.
  27.  
  28.      -m _✓m_✓e_✓m_✓s_✓i_✓z_✓e
  29.           Sets the amount  of  memory  clisp  tries  to  grab  on
  30.           startup.   The amount may be given as _✓n_✓n_✓n_✓n_✓n_✓n_✓n (measured
  31.           in bytes), _✓n_✓n_✓n_✓nK or _✓n_✓n_✓n_✓nKB (measured in  kilobytes)  or
  32.           _✓nM  or _✓nMB (measured in megabytes).  Default is 2 mega-
  33.           bytes.  The argument is constrained between 100 KB  and
  34.           16  MB.   --  This  version  of  _✓c_✓l_✓i_✓s_✓p allocates memory
  35.           dynamically.  _✓m_✓e_✓m_✓s_✓i_✓z_✓e is essentially ignored.
  36.  
  37.      -s _✓s_✓t_✓a_✓c_✓k_✓s_✓i_✓z_✓e
  38.           Sets the size of the stack clisp allocates for  itself.
  39.           The  syntax is the same as for _✓m_✓e_✓m_✓s_✓i_✓z_✓e.  Default is one
  40.           eighth of _✓m_✓e_✓m_✓s_✓i_✓z_✓e.  The argument is constrained between
  41.           40 KB and 8 MB.
  42.  
  43.      -M _✓m_✓e_✓m_✓f_✓i_✓l_✓e
  44.           Specifies the initial memory image.   This  must  be  a
  45.           memory dump produced by the _✓s_✓a_✓v_✓e_✓i_✓n_✓i_✓t_✓m_✓e_✓m function.
  46.  
  47.      -q   Quiet: clisp displays  no  banner  at  startup  and  no
  48.           good-bye message when quitting.
  49.  
  50.      -i _✓i_✓n_✓i_✓t_✓f_✓i_✓l_✓e ...
  51.           Specifies initialization files to be _✓l_✓o_✓a_✓ded at startup.
  52.           These should be lisp files (source or compiled).
  53.  
  54.      -c _✓l_✓i_✓s_✓p_✓f_✓i_✓l_✓e ...
  55.           Compiles the specified lispfiles to bytecode. The  com-
  56.           piled  files  can then be _✓l_✓o_✓a_✓ded instead of the sources
  57.           to gain efficiency.
  58.  
  59.      -l   A bytecode listing of the files being compiled will  be
  60.  
  61.  
  62.  
  63. Sun Release 4.1     Last change: 16 May 1993                    1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CLISP(1)                 USER COMMANDS                   CLISP(1)
  71.  
  72.  
  73.  
  74.           produced.  Useful only for debugging purposes.
  75.  
  76.      -x _✓e_✓x_✓p_✓r_✓e_✓s_✓s_✓i_✓o_✓n_✓s
  77.           Executes a series of arbitrary expressions instead of a
  78.           read-eval-print  loop.   The  values of the expressions
  79.           will be output to standard output.  Due to the argument
  80.           processing  done  by the shell, the _✓e_✓x_✓p_✓r_✓e_✓s_✓s_✓i_✓o_✓n_✓s must be
  81.           enclosed  in  single  quotes,  and  double  quotes  and
  82.           backslashes must be preceded by backslashes.
  83.  
  84. REFERENCE
  85.      The language implemented conforms to
  86.             Guy L. Steele Jr.: Common Lisp - The Language.
  87.             Digital Press. 1st edition 1984, 465 pages.
  88.             ("CLtL1" for short)
  89.      and to the older parts of
  90.             Guy L. Steele Jr.: Common Lisp - The Language.
  91.             Digital Press. 2nd edition 1990, 1032 pages.
  92.             ("CLtL2" for short)
  93.  
  94. USE
  95.      help to get some on-line help.
  96.  
  97.      (apropos _✓n_✓a_✓m_✓e)
  98.           lists the symbols relating to _✓n_✓a_✓m_✓e.
  99.  
  100.      (exit) or (quit) or (bye)
  101.           to quit clisp.
  102.  
  103. FILES
  104.      _✓l_✓i_✓s_✓p._✓p_✓r_✓g
  105.           main executable
  106.  
  107.      _✓l_✓i_✓s_✓p_✓i_✓n_✓i_✓t._✓m_✓e_✓m
  108.           initial memory image
  109.  
  110.      _✓c_✓o_✓n_✓f_✓i_✓g._✓l_✓s_✓p
  111.           site-dependent configuration
  112.  
  113.      *._✓l_✓s_✓p
  114.           lisp source
  115.  
  116.      *._✓f_✓a_✓s
  117.           lisp code, compiled by clisp
  118.  
  119.      *._✓l_✓i_✓b
  120.           lisp source library information, generated and used  by
  121.           the clisp compiler
  122.  
  123. ENVIRONMENT
  124. SEE ALSO
  125.      _✓c_✓m_✓u_✓l_✓i_✓s_✓p(1), _✓e_✓m_✓a_✓c_✓s(1).
  126.  
  127.  
  128.  
  129. Sun Release 4.1     Last change: 16 May 1993                    2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. CLISP(1)                 USER COMMANDS                   CLISP(1)
  137.  
  138.  
  139.  
  140. BUGS
  141.      The function _✓i_✓n_✓s_✓p_✓e_✓c_✓t is not implemented.
  142.  
  143.      Only very few extensions from CLtL2 are supported.
  144.  
  145.      No on-line documentation  beyond  _✓a_✓p_✓r_✓o_✓p_✓o_✓s  and  _✓d_✓e_✓s_✓c_✓r_✓i_✓b_✓e  is
  146.      available.
  147.  
  148. PROJECTS
  149.      Writing on-line documentation.
  150.  
  151.      Building a foreign function interface  (ability  to  call  C
  152.      code directly).
  153.  
  154.      Write _✓i_✓n_✓s_✓p_✓e_✓c_✓t.
  155.  
  156.      Enhance the compiler such that it  can  inline  local  func-
  157.      tions.
  158.  
  159.      Specify a portable set of window and graphics operations.
  160.  
  161. AUTHORS
  162.      Bruno Haible <haible@ma2s2.mathematik.uni-karlsruhe.de>  and
  163.      Michael Stoll.
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. Sun Release 4.1     Last change: 16 May 1993                    3
  196.  
  197.  
  198.  
  199.